home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / arc.z / arc
Encoding:
Text File  |  2002-10-03  |  5.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. aaaarrrrcccc((((3333GGGG))))                                                                aaaarrrrcccc((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      aaaarrrrcccc,,,, aaaarrrrcccciiii,,,, aaaarrrrccccssss - draw a circular arc
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd aaaarrrrcccc((((xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss,,,, ssssttttaaaarrrrttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg))))
  13.      CCCCoooooooorrrrdddd xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss;;;;
  14.      AAAAnnnngggglllleeee ssssttttaaaarrrrttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg;;;;
  15.  
  16.      vvvvooooiiiidddd aaaarrrrcccciiii((((xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss,,,, ssssttttaaaarrrrttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg))))
  17.      IIIIccccoooooooorrrrdddd xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss;;;;
  18.      AAAAnnnngggglllleeee ssssttttaaaarrrrttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg;;;;
  19.  
  20.      vvvvooooiiiidddd aaaarrrrccccssss((((xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss,,,, ssssttttaaaarrrrttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg))))
  21.      SSSSccccoooooooorrrrdddd xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss;;;;
  22.      AAAAnnnngggglllleeee ssssttttaaaarrrrttttaaaannnngggg,,,, eeeennnnddddaaaannnngggg;;;;
  23.  
  24.      All of the routines named above are functionally the same.  They differ
  25.      only in the type assignments of their parameters.
  26.  
  27. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  28.      _x          expects the _x coordinate of the center of the arc. The center
  29.                 of the arc is the center of the circle that would contain the
  30.                 arc.
  31.  
  32.      _y          expects the _y coordinate of the center of the arc.  The center
  33.                 of the arc is the center of the circle that would contain the
  34.                 arc.
  35.  
  36.      _r_a_d_i_u_s     expects the length of the radius of the arc.  The radius of
  37.                 the arc is the radius of the circle that would contain the
  38.                 arc.
  39.  
  40.      _s_t_a_r_t_a_n_g   expects the measure of the start angle of the arc. The start
  41.                 angle of the arc is measured from the positive x-axis.
  42.  
  43.      _e_n_d_a_n_g     expects the measure of the end angle of the arc. The end angle
  44.                 of the arc is measured from the positive x-axis.
  45.  
  46. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  47.      aaaarrrrcccc draws an unfilled circular arc in the _x-_y plane (_z = _0). To draw an
  48.      arc in a plane other than the _x-_y plane, define the arc in the _x-_y plane
  49.      and then rotate or translate the arc.
  50.  
  51.      An arc is drawn as a sequence of line segments, and therefore inherits
  52.      all properties that affect the drawing of lines.  These include the
  53.      current color, writemask, line width, stipple pattern, shade model, line
  54.      antialiasing mode, and subpixel mode.  The stipple pattern is initialized
  55.      to bit zero of the current linestyle before the arc is drawn, then
  56.      shifted continuously through the segments of the arc.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. aaaarrrrcccc((((3333GGGG))))                                                                aaaarrrrcccc((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      An arc is defined in terms of the circle that contains it.  All
  75.      references to the radius and center of the arc refer to the radius and
  76.      center of the circle that contains the arc. The angle swept out by the
  77.      arc is the angle from the start angle counter-clockwise to the end angle.
  78.  
  79.      The start and end angles are defined relative to the positive x-axis. (To
  80.      speak more precisely, because the arc might not be centered on the
  81.      origin, the start and end angles are defined relative to the right
  82.      horizontal radius of the circle containing the arc).  Positive values for
  83.      an angle indicate a counter-clockwise rotation from the horizontal.
  84.      Negative values indicate a clockwise rotation from the horizontal.
  85.  
  86.      The basic unit of angle measure is a tenth of a degree. The value 900
  87.      indicates an angle of 90 degrees in a counter-clockwise direction from
  88.      the horizontal. Thus, an arc that spans from a start angle of 10 degrees
  89.      (_s_t_a_r_t_a_n_g = _1_0_0) to an end angle of 5 degrees (_e_n_d_a_n_g = _5_0) is almost a
  90.      complete circle.
  91.  
  92.      After aaaarrrrcccc executes, the graphics position is undefined.
  93.  
  94. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  95.      arcf, bgnclosedline, circ, crvn, linewidth, linesmooth, lsrepeat,
  96.      scrsubdivide, setlinestyle, shademodel, subpixel
  97.  
  98. BBBBUUUUGGGGSSSS
  99.      When the line width is greater than 1, small notches will appear in arcs,
  100.      because of the way wide lines are implemented.
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.